home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / MSDOS / (m)aac / README.DOC < prev    next >
Text File  |  1986-08-08  |  16KB  |  410 lines
  1. Introduction
  2.  
  3.      As-EASY-As is a spreadsheet program written in Borland's Turbo Pascal 
  4. and  consists  of  just  over  60000  bytes  of  COM  code.   Static  data 
  5. requirements are about 52000 bytes.  Each cell  element  is  stored  as  a 
  6. dynamic  variable on the heap.  To insure an adequate workspace I recomend 
  7. that this program be used on machines with at least 256K of  memory.  This 
  8. program is activated from DOS by typing;
  9.  
  10.           ASEASY    [enter]
  11.  
  12. The default drive for worksheets has been set to drive b.
  13. This may be changed by placing a program switch on the command line.
  14.  
  15.           ASEASY  /A  [enter]             {switches default to 'A:'}
  16.           ASEASY  /C  [enter]             {switches default to 'C:'}
  17.  
  18. For  computers  which  utilize the Monochrome screen the following must be 
  19. used;
  20.  
  21.           ASEASY  /M  [enter]             {if there is a graphics display
  22.                                            turn it off as the screen access is
  23.                                            slowed down otherwise}
  24.  
  25. If you want a different set of colors on the color screen use this;
  26.  
  27.           ASEASY  /S=G [enter]            {sets cursor to green}
  28.           ASEASY  /S=B [enter]            {sets cursor to brown}
  29.  
  30.      The current size of the spreadsheet has been set at 52 columns by 200 
  31. rows.  The  program was developed concurrently on a Heath/Zenith Z-152 and 
  32. an IBM PC with 640K of memory.  It has been successfully tested on both  a 
  33. Compaq and an IBM PC jr.
  34.  
  35.      Formulas and functions have been provided as well as text entry.
  36.  
  37.      Version 1A does not support path names.
  38.  
  39.      Absolute and relative cell formula references are allowed.  All block
  40. moves of formulas automatically resolve and change these references.
  41.  
  42.      Cell formulas are calculate via a linked calculation sequence. When a 
  43. cell has been updated only referring cells are recalculated.  This saves a 
  44. great  amount  of  time  when the number of formulii in the spreadsheet is 
  45. large as only those cells that need to be recalculated are effected.  
  46.  
  47.      Floating point errors are indicated by the appearance of *ERR* at the
  48. position of the  numerical  error.  Additionally all cells referencing the 
  49. error will also display the *ERR* message.  All internal floating point 
  50. calculations use a 6 byte format ( 1 exponent, 5 mantissa ) which provides 
  51. 11  digit accuracy.  Formatted numbers which exceed the current width of a 
  52. column are displayed as a field of asterix's.  
  53.  
  54.      Worksheets are saved in files with an extension '.WKS'.  This  format 
  55. is  compatible  with  an  existing  popular  spreadsheet.  Portions of the 
  56. spreadsheet may be extracted or combined with the file commands.
  57.  
  58.      The contents of the cell highlighted by the cursor  is  displayed  on 
  59. the  top line of the screen.  The code associated with the assigned format 
  60. of the cell is displayed to the left of the cell contents. The cell may be 
  61. edited by pressing the [F2] key.
  62.  
  63.      In the lower left of  the  spreadsheet  the  amount  of  free  memory 
  64. is  displayed  as  a percentage of total memory.  The status of the CAPS , 
  65. NUMLCK ,SCROLLK and END keys is displayed on the bottom line.  The current 
  66. cell  being calculated is also displayed on this line.  At the lower right 
  67. of the screen is a clock displaying the current time.
  68.  
  69. --------------------------------------------------------------------------
  70. Spreadsheet Cursor Movements
  71.  
  72.    The spreadsheet  cursor may be moved about the screen with the following
  73. keys.
  74.  
  75.    {Left}       moves cursor left one column
  76.    {Right}      moves cursor right one column
  77.    {Up}         moves cursor up one row
  78.    {Down}       moves cursor down one row
  79.    {Home}       moves cursor to cell A1, upper left corner of spreadsheet
  80.    {pageUp}     moves cursor up one page , 20 rows
  81.    {PageDn}     moves cursor down one page, 20 rows
  82.    {TabRight}   moves cursor right one page
  83.    {TabLeft}    moves cursor left one page
  84.    {End}        Moves to extreme limit of field when pressed prior to
  85.                 {left}, {right}, {up}, {down}
  86.                 Moves to lower left of spreadsheet when pressed prior to {Home}
  87.  
  88. ------------------------------------------------------------------------------
  89. Editing Cursor Movements
  90.  
  91.     To edit the contents of a  cell  press  the  [f2]  function  key.  The 
  92. contents  of  the cell are echoed on the second line of the screen and the 
  93. cursor is positioned at the end of the line.
  94.  
  95.  {Left}         moves cursor left one character
  96.  {Right}        moves cursor right one character
  97.  {Up}           exits editing mode,saving changes and moves cursor up one row
  98.  {Down}         exits editing mode,saving changes and moves cursor down one row
  99.  {Home}         moves cursor to first character
  100.  {TabRight}     moves cursor 8 characters to the right
  101.  {TabLeft}      moves cursor 8 characters to the left
  102.  {End}          Moves cursor to last character on line
  103.  {ctrl}{right}  Moves to beginning of next word to the right
  104.  {ctrl}{left}   Moves to beginning of next word to the left
  105.  {Ins}          Inserts a space at cursor position
  106.  {Del}          Deletes character under cursor
  107.  {BackSpace}    Deletes character to left of cursor
  108.  
  109. ------------------------------------------------------------------------------
  110. Function Keys
  111.  
  112. [F2]           Edit - Initiates editing of current cell highlighted by
  113.                       spreadsheet cursor
  114.  
  115. [F5]           Goto - Prompts for cell to reposition cursor
  116.  
  117. [F9]           Calc - Recalculates entire spreadsheet in rowwise sequence
  118.  
  119. [F10]          Graph - Graphs currently defined data ranges
  120.  
  121. ------------------------------------------------------------------------------
  122.  
  123. Text Formatting
  124.  
  125.    Text may be justified  by  preceding  it  with  one  of  the  following 
  126.    characters;
  127.  
  128.  
  129.    \           The label following this will be repeated to the width
  130.                of the column
  131.  
  132.    ^           Centers label in column
  133.  
  134.    '           Left justifies label ,  this is optional
  135.  
  136.    "           Right justifies label
  137.  
  138. ------------------------------------------------------------------------------
  139.  
  140. Menu Options
  141.  
  142.     The menu is activated by pressing the '/' key. The menu appears on the 
  143. second line of the screen and the first  command  option  is  highlighted. 
  144. Each  option  may  be  selected  via moving the cursor with the {Left} and 
  145. {Right} cursor keys so as to highlight the command choice.  Once  this  is 
  146. done  the  command is activated by pressing the {ENTER} key.  An alternate 
  147. method of selecting an option is to type the first letter of the option.
  148.  
  149.     The third line of the  screen  provides  some  additional  information 
  150. about  the highlighted option ( sub menus or an explanation of the command).
  151.  
  152.     Following is a list of the command  options.  The  [ESC]  key  may  be 
  153. pressed to step backwards out of a menu or cancel a command choice.
  154.  
  155. Main Menu    Sub Menu
  156.  
  157. /Worksheet
  158.              Global       - Set global format
  159.              Insert       - Insert  row(s) or column(s) at cursor position
  160.              Delete       - Delete  row(s) or column(s) at cursor position
  161.              ColumnWidth  - Adjust the column width
  162.              Status
  163.                Manual     - Select manual recalculation, press [F9]
  164.                Automatic  - Select automatic recalculation
  165.                Iterations - Set the number of times a single cell may
  166.                             recalculated due to a looped reference.
  167.                             Default is 1 iteration.
  168.                SheetBounds- Display the current worksheet boundary
  169.  
  170.              Quit         - Return to main menu
  171. /Range
  172.              Format       - Fixed, Scientific, ',' , Currency, Percent
  173.              Erase        - Erase a range of cells
  174.  
  175. /Copy                     - copies a block of data to position of cursor
  176.  
  177. /Move                     - moves a block of data to position of cursor
  178.  
  179. /File
  180.              Retrieve     - Read  .WKS file into spreadsheet
  181.              Save         - Write spreadsheet as a .WKS file
  182.              Xtract       - Extract a portion of the sheet as .WKS file
  183.              Merge        - Merge an existing sheet to the current sheet
  184.                             Direct substitution occurs
  185.              List         - List worksheet files on disk in current drive
  186.              Dir          - Change current drive
  187.              Quit         - Return to main menu
  188. /Print
  189.     Printer               - send output to lpt1
  190.     File                  - send output to a disk file
  191.  
  192.              Range        - Define range of spreadsheet to be printed
  193.              Page         - Advance printer to top of next page
  194.              Line         - Advance printer one line up
  195.              Align        - ReSet line pointer to top of page
  196.              Options
  197.                RtMargin   - Set Right Margin  (0..240)
  198.                LtMargin   - Set left  Margin  (0..240)
  199.                Setup      - Control codes to printer in ascii ,i.e.  \027\069
  200.                PageLength - Set the number of lines per page ,default 66
  201.                Header     - Set a single line for header message
  202.                Footer     - Set a single line for footer message
  203.                Quit       - return to previous menu
  204.  
  205.              Go           - Initiate the printing of the file
  206.              Quit         - return to the main menu
  207. /Graph
  208.              Type
  209.                x-y        - x-y line and/or with symbols graph
  210.                Bar        - Bar chart
  211.                Quit       - Return to previous menu
  212.  
  213.              X            - define x  - ordinate data range to be plotted
  214.              A            - define first y - ordinate data range
  215.              B            - define second y - ordinate data range
  216.              C            - define third y - ordinate data range
  217.              Scale
  218.                X-axis
  219.                  Upper    - Set Upper Scale limit
  220.                             ( note upper can be less than lower limit )
  221.  
  222.                  Lower    - Set lower Scale limit
  223.                  Format   - select display format,  i.e. currency, percent ...
  224.                  Step     - Select number of steps across axis
  225.                  Quit     - Return to previous menu
  226.  
  227.              Options
  228.                Titles
  229.                  Main     - Define main title string on graph
  230.                  Second   - Define second title string on graph
  231.                  X-Axis   - Define the x-axis title
  232.                  Y-Axis   - Define the y-axis title
  233.  
  234.                Green      - Set hires screen color to green
  235.                Brown      - Set hires screen color to brown
  236.                Quit       - Return to previous menu
  237.  
  238.              View         - View the graph { requires graphics screen 200x640 }
  239.              Quit         - Return to the main menu
  240.  
  241. /Quit                     - Exit the spreadsheet to DOS.
  242.  
  243. ------------------------------------------------------------------------------
  244. Mathematical Operators
  245.  
  246.   Cells  are referenced as absolute or relative.  An absolute cell has the 
  247. row or column to be fixed preceded by a '$'.  i.e.  $A1 fixes  column  'A' 
  248. portion of cell.  A block copy of this cell will not alter the 'A' portion 
  249. of the cell.  $A$1 fixes both the row  an  column  portion  of  the  cell. 
  250. Without  the  '$'  all  copies  of  the  cell  formula  will  result  in a 
  251. translation of  the  cell  reference  so  that  it  maintains  a  relative 
  252. reference. Cell references must be preceded by either a '+' or '-' sign.
  253.  
  254.  
  255.    -  Performs negation of following term
  256.    +  Addition
  257.    -  Subtraction
  258.    *  Multiplication
  259.    /  Division
  260.    ^  Exponentiation
  261.  
  262. Example   in cell A1 =       +B1-A2*3+A4^3
  263. ------------------------------------------------------------------------------
  264.  
  265. Logical Operators
  266.  
  267.  Operators return a value of 1 if true and 0 if false.
  268.  
  269.    =   Equal
  270.    <>  Not Equal
  271.    >=  Greater Than or Equal
  272.    <=  Less Than or Equal
  273.    <   Less Than
  274.    >   Greater Than
  275.  
  276.   AND
  277.   OR
  278.   NOT
  279.   NA
  280.  
  281. ------------------------------------------------------------------------------
  282. Function
  283.  
  284. @ABS(x)      absolute value of arguement
  285.  
  286. @INT(x)      Integer value of arguement,
  287.              -35680 < x < 35678
  288.  
  289. @SQRT(x)     Square root of arguement
  290.  
  291. @LOG(x)      Logarithmn to base '10'
  292.  
  293. @LN(x)       Natural Logarithmn base 'e'
  294.  
  295. @PI          Constant has a value of 3.14159...
  296.  
  297. @SIN(x)      Sine of angle, x in radians
  298.  
  299. @COS(x)      Cosine of angle, x in radians
  300.  
  301. @TAN(x)      Tangent of angle, x in radians
  302.  
  303. @ATAN(x)     Arc Tangent of value, returns radians
  304.  
  305. @ASIN(x)     Arc sine of value, returns radians
  306.  
  307. @ACOS(x)     Arc cosine of value, returns radians
  308.  
  309. @EXP(x)      Raise 'e' to the 'x' power
  310.  
  311. @MOD(x,y)    Modula division, returns remainder of x/y
  312.  
  313. @NA          Constant has a value of -1
  314.  
  315. @TRUE        Constant has a value of 1
  316.  
  317. @FALSE       Constant has a value of 0
  318.  
  319. @RAND        Returns a variable random number
  320.  
  321. @DATE(Year,Month,Day)
  322.  
  323.              Returns a unique integer for each day since Jan 1,1900
  324.  
  325. @TODAY       Returns the unique integer corresponding to todays date
  326.              referenced to Jan 1, 1900
  327.  
  328.  
  329.  
  330. @IF(Test arguement,arg1,arg2)
  331.  
  332.              Based on result of test returns      value of arg1 if true
  333.                                                   value of arg2 if false
  334.  
  335.              Test must utilize logical operators  >,<,=,<>  etc.
  336.  
  337.              i.e.  @if(10>2,3*2,4+5) = 6
  338.                    @IF(10<2,3*2,4+5) = 9
  339.  
  340. @YEAR(x)     Based on unique day assigned to 'x', computes the year in which
  341.              day occurs
  342.  
  343. @ROUND(x,y)  Rounds real value to y digits after decimal
  344.  
  345.                i.e.  @ROUND(10.123,1) =  10.1
  346. ------------------------------------------------------------------------------
  347. Financial Functions
  348.  
  349. @PMT(Principal,interest rate,period)
  350.  
  351.              Returns the amount of an annuity equal to the principal
  352.              amortized over the period.
  353.  
  354. @PV(Annuity,interest rate,period)
  355.  
  356.              Returns the present value corresponding to an annuity occuring
  357.              over the specified period.  Reverse of the above.
  358.  
  359. @FV(Annuity,interest rate,period)
  360.  
  361.              Returns the future value corresponding to an annuity occuring
  362.              over the specified period.  Reverse of the above.
  363.  
  364. ------------------------------------------------------------------------------
  365. Statistical Functions
  366.  
  367.      These functions operate on a range of values.  A range specifies
  368.      a rectangular block of data in the spreadsheet.
  369.      Only one range may be used as an arguement.  i.e.   Range  =  A1..B10
  370.      defines the block of data from    a1 ...b1
  371.                                         .    .
  372.                                         .    .
  373.                                       a10...b10
  374.  
  375.      When specifying the range two dots 'must' be used to seperate cells.
  376.  
  377.  
  378. @SUM(Range)  Returns the summation of the range
  379.  
  380. @AVG(Range)  Returns the average of the range
  381.  
  382. @COUNT(Range)  Returns the number of elements in the range
  383.  
  384. @MIN(Range)  Returns the value of then minimum element in the range
  385.  
  386. @MAX(Range)  Returns the value of the maximum element in the range
  387.  
  388. @VAR(Range)  Returns the population variance of the elements in the range
  389.  
  390. @STD(Range)  Returns the standard deviation of the elements in the range
  391.  
  392. ------------------------------------------------------------------------------
  393. Hyperbolic Functions
  394.  
  395. @SINH(x)     Hyperbolic Sine
  396.  
  397. @COSH(x)     Hyperbolic Cosine
  398.  
  399. @TANH(x)     Hyperbolic Tangent
  400.  
  401. @ASINH(x)    Arc of Hyperbolic Sine
  402.  
  403. @ACOSH(x)    Arc of Hyperbolic Cosine
  404.  
  405. @ATANH(x)    Arc of Hyperbolic Tangent
  406.  
  407. ------------------------------------------------------------------------------
  408.       Uploaded to the IBM PC SIG Of DiSC III on Aug 8, 1986
  409.         DiSC III (416)487-2889  300/1200/2400 baud 24hrs
  410.